BACKUP.OD

Section: Misc. Reference Manual Pages (1L)
Updated: 15 June 1990
Index Return to Main Contents
 

NAME

backup.od - backup files to an optical disk  

SYNOPSIS

backup.od [ -m ] [ -a time ] [ directory ]  

DESCRIPTION

backup.od makes a tar file on an optical disk. The tar file contains all the files and, recursively, directories in the specified directory, or all the files and directories in the specified directory that have changed since the last backup. It also makes a list file that contains the names of all the files placed into the tar file.

If a directory name is not specified, the user's home directory is used.

If there is not a readable file named ".backup.od" in the specified directory when backup.od runs, all files are copied. If the file exists, only those files that have been modified after the timestamp of ".backup.od" are copied. backup.od creates a file in the specified directory named ".backup.od" each time it runs. So, if an automatic backup is started, it will make a full backup the first time, and incremental backups thereafter.

Full backups are written to files named "fl.month.day.hour.tar", with the list file being written to "fl.month.day.hour.lst". If a full backup exists for the same month, day, and hour, it is overwritten. A message to that effect is written to stdout.

Incremental backups are written to files named "sv.month.day.hour.tar", with the list file being written to "sv.month.day.hour.lst". If an incremental backup exists for the same month, day, and hour, backup.od fails. A message saying that the file exists is written to stdout.

Using the -a time flag, the backup may be started at time rather than at the current time. If the -a flag is specified, backup.od will reschedule itself for time when it completes the backup. Doing this, daily unattended backups may be specified. When the -a flag is used, stdout and stderr are mailed to $USER.

If the -m flag is used, backup.od requests that an optical disk be mounted, and waits until one is inserted before making the tar and list files. The disk is ejected when backup.od is finished.

If the -m flag is not used, the optical disk must be mounted on /tmp/backup, and must have a directory named /tmp/backup/$USER. $USER must have write permission to this directory. The tar files and list files are written to that directory. This allows multiple users to make backups at the same time.  

OPTIONS

-a time
Delays start of backup.od until time. time may be any time acceptable to the at(1) program. If time is more than one word, it must be quoted.
-m
Instead of using an optical disk that is already mounted on /tmp/backup, ask the user to insert an optical, make the backup, then eject the optical.
 

FILES

.backup.od
list of files in last backup; timestamp for next incremental backup
/tmp/backup
Directory where the optical disk is mounted
fl.month.day.hour.lst
List of files in fl.month.day.hour.tar
fl.month.day.hour.tar
Files copied from user's directory
sv.month.day.hour.lst
List of files in sv.month.day.hour.tar
sv.month.day.hour.tar
Files copied from user's directory
 

SEE ALSO

at(1), mountod(1l), unmountod(1l)  

AUTHORS

Dave Hanson wrote the program originally for CFS. Pat McGee added lots of bells and whistles and ported it to the NeXT.  

BUGS

It is possible, but not very useful to use the -m and -a flags together. In this case, backup.od will start at the appointed time, will display the prompt to insert an optical, and will wait until an optical disk is inserted.

If an uninitialized optical disk is inserted, this command will fail with the message "mount: /dev/od0a on directory: No such device or address.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
SEE ALSO
AUTHORS
BUGS

This document was created by man2html, using the manual pages.
Time: 08:43:10 GMT, October 25, 2024